home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / standard / lsetdepth.z / lsetdepth
Text File  |  1998-10-20  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4. llllsssseeeettttddddeeeepppptttthhhh((((3333GGGG))))                                                    llllsssseeeettttddddeeeepppptttthhhh((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      llllsssseeeettttddddeeeepppptttthhhh - sets the depth range
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd llllsssseeeettttddddeeeepppptttthhhh((((nnnneeeeaaaarrrr,,,, ffffaaaarrrr))))
  13.      lllloooonnnngggg nnnneeeeaaaarrrr,,,, ffffaaaarrrr;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _n_e_a_r   expects the screen coordinate of the near clipping plane.
  17.  
  18.      _f_a_r    expects the screen coordinate of the far clipping plane.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      vvvviiiieeeewwwwppppoooorrrrtttt specifies the mapping of the left, right, bottom, and top
  22.      clipping planes into screen coordinates.  llllsssseeeettttddddeeeepppptttthhhh completes this
  23.      mapping for homogeneous world coordinates; it specifies the mapping of
  24.      the near and far clipping planes into values stored in the z-buffer.
  25.  
  26.      llllsssseeeettttddddeeeepppptttthhhh is used in z-buffering, depth-cueing, and certain feedback
  27.      applications.
  28.  
  29.      The valid range of the parameters depends on the state of the
  30.      GLC_ZRANGEMAP compatibility mode (see ggggllllccccoooommmmppppaaaatttt).  If it is 0, the valid
  31.      range depends on the graphics hardware.  When multisample is enabled, and
  32.      multisample buffers exist in the current framebuffer configuration in the
  33.      current drawmode, the minimum is the value returned by
  34.      ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____MMMMSSSS____ZZZZMMMMIIIINNNN)))) and the maximum is the value returned by
  35.      ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____MMMMSSSS____ZZZZMMMMAAAAXXXX)))).  Otherwise, the minimum is the value returned by
  36.      ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____ZZZZMMMMIIIINNNN)))) and the maximum is the value returned by
  37.      ggggeeeettttggggccccoooonnnnffffiiiigggg((((GGGGCCCC____ZZZZMMMMAAAAXXXX)))).  If the state of the GLC_ZRANGEMAP compatibility
  38.      mode is 1, the minimum is 0x0 and the maximum is 0x7FFFFF.  The depth
  39.      range defaults to the full range supported by the graphics hardware.
  40.  
  41.      Acceptable mappings include all those where both _n_e_a_r and _f_a_r are within
  42.      the supported range, including mappings where _n_e_a_r > _f_a_r.  In particular,
  43.      it is sometimes desirable to call llllsssseeeettttddddeeeepppptttthhhh((((0000xxxx7777FFFFFFFFFFFFFFFFFFFF,,,, 0000xxxx0000)))) on IRIS-4D GT
  44.      and GTX models.
  45.  
  46. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  47.      depthcue, feedback, getgdesc, glcompat, zbuffer
  48.  
  49. NNNNOOOOTTTTEEEESSSS
  50.      Error accumulation in the iteration of _z can cause wrapping when the full
  51.      depth range supported by the graphics hardware is used.  (An iteration
  52.      wraps when it accidentally converts an large positive value into a
  53.      negative value, or vice versa.)  While the effects of wrapping are
  54.      typically not observed, if they are, they can be eliminated by reducing
  55.      the depth range by a small percentage.
  56.  
  57.      When using this routine, you should always explicitly set the
  58.      GLC_ZRANGEMAP mode of ggggllllccccoooommmmppppaaaatttt because its default is different on
  59.      different models.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.